跳到主要内容

特性支持(Feature Support)

随着 Rive Editor 持续迭代,某些新特性需要 Runtime 更新才能完整支持,部分场景还会引入新 API 或 API 变更。
建议尽量使用最新 Runtime 版本,以获得更好的兼容性、稳定性与性能。

你可以用本页快速判断:你的 .riv 文件所用特性,是否被目标 Runtime 支持

警告(Warning):部分特性需要使用 Rive Renderer(渲染器)。

请先阅读:

当前明确依赖 Rive Renderer 的特性是:

  • Vector Feathering(矢量羽化)

当某项特性涉及 API 迁移时,官方通常会在对应 Runtime 文档中附带迁移说明。

按 Runtime 查看支持

当前 Runtime(Current)

  • Web - WebGL2(推荐)
  • Web - Canvas
  • React - WebGL2
  • React - Canvas
  • React Native(Nitro)
  • Flutter
  • Apple
  • Android
  • C++
  • Unity
  • Unreal

Lite Runtime

  • Web - Canvas Lite
  • React - Canvas Lite

Lite 版本通常 API 与标准 Canvas 版本接近,但会裁剪部分特性以减小包体。

Legacy Runtime(已弃用)

  • Web - WebGL(@rive-app/webgl
  • React - WebGL(@rive-app/react-webgl
  • React Native Legacy(rive-react-native

建议迁移到:

  • Web:@rive-app/webgl2
  • React:@rive-app/react-webgl2
  • React Native:rive-nitro-react-native

按特性查看支持

官方页面使用 ✅ / 🟡 标记:

  • ✅:在**当前 Runtime(不含 Legacy)**中全部支持
  • 🟡:支持因 Runtime / 渲染器 / 平台能力而有差异

注意(Note):某特性即使在 Legacy 中不支持,仍可能被视为“当前 Runtime 全支持”。

主要特性清单

Legacy 特性(不建议新项目继续依赖)

  • Events(事件)
    • 运行时监听 Rive Events 已进入弃用路径。
    • 建议改用 Data Binding 监听 Trigger 或属性变化。
  • Nested Text(嵌套文本运行时赋值)
    • 旧版 text run 直接改值能力处于弃用路径。
    • 建议改用 Data Binding 的 string 属性绑定文本。

选型建议

  1. Web / React 优先 WebGL2:新特性支持与性能通常更好。
  2. 仅在包体敏感时使用 Lite:先确认目标特性未被裁剪。
  3. 新项目避免 Legacy Runtime:减少迁移成本与潜在兼容风险。
  4. 遇到渲染差异先检查 Renderer 路径:尤其是 Vector Feathering。

相关文档

版本支持矩阵(Runtime × Feature × 最低版本)

数据来源:官方 snippets/feature-support.jsx。 说明:✅ x.y.z+ 表示支持且给出最低版本;Not supported/Not yet supported/Deprecated 为官方原文状态。

阅读建议:按需展开分组与 Runtime,避免一次性查看超长表格。

当前 Runtime(Current)

Web - WebGL2(Web - WebGL2)
特性支持状态 / 最低版本
脚本(Scripting)2.34.0+
数据绑定列表/图片/画板(Data Binding - Lists, Images, Artboards)2.30.3+
RTL 布局与文本(Right to Left Layouts & Text)2.26.7+
文本沿路径(Text Follow Path)2.26.7+
数据绑定(Data Binding)2.26.6+
矢量羽化(Vector Feathering)2.26.0+
N-Slicing(N-Slicing)2.23.11+
布局(Layouts)2.23.3+
后备字体(Fallback Fonts)Not yet supported
随机化(Randomization)2.15.6+
音频(Audio)2.15.6+
带外资源(Out-of-band Assets)2.11.0+
文本(Text)2.11.0+
路径跟随(Follow Path)2.11.0+
状态插值(Interpolation on States)2.11.0+
摇杆(Joysticks)2.11.0+
独奏(Solos)2.11.0+
状态速度(Speed on States)2.11.0+
图形编辑器(Graph Editor)2.11.0+
监听器(Listeners)2.11.0+
网格形变(Mesh Deformation)2.11.0+
缓存 Rive 文件(Caching a Rive File)2.11.0+
光栅资源(Raster Assets)2.11.0+
事件(Events,已弃用)2.11.0+
嵌套文本(Nested Text,已弃用)2.11.0+
Web - Canvas(Web - Canvas)
特性支持状态 / 最低版本
脚本(Scripting)2.34.0+
数据绑定列表/图片/画板(Data Binding - Lists, Images, Artboards)2.30.3+
RTL 布局与文本(Right to Left Layouts & Text)2.26.7+
文本沿路径(Text Follow Path)2.26.7+
数据绑定(Data Binding)2.26.6+
矢量羽化(Vector Feathering)Not supported
N-Slicing(N-Slicing)2.23.11+
布局(Layouts)2.23.3+
后备字体(Fallback Fonts)Not yet supported
随机化(Randomization)2.15.6+
音频(Audio)2.15.6+
带外资源(Out-of-band Assets)2.7.0+
文本(Text)2.1.3+
路径跟随(Follow Path)1.2.4+
状态插值(Interpolation on States)1.2.1+
摇杆(Joysticks)1.1.9+
独奏(Solos)1.1.2+
状态速度(Speed on States)1.0.102+
图形编辑器(Graph Editor)1.0.97+
监听器(Listeners)1.0.65+
网格形变(Mesh Deformation)1.0.47+
缓存 Rive 文件(Caching a Rive File)✅ Supported
光栅资源(Raster Assets)1.0.2+
事件(Events,已弃用)2.4.3+
嵌套文本(Nested Text,已弃用)2.21.0+
React - WebGL2(React - WebGL2)
特性支持状态 / 最低版本
脚本(Scripting)4.26.0+
数据绑定列表/图片/画板(Data Binding - Lists, Images, Artboards)4.22.0+
RTL 布局与文本(Right to Left Layouts & Text)4.18.6+
文本沿路径(Text Follow Path)4.18.6+
数据绑定(Data Binding)4.20.0+
矢量羽化(Vector Feathering)4.18.0+
N-Slicing(N-Slicing)4.16.7+
布局(Layouts)4.16.0+
后备字体(Fallback Fonts)Not yet supported
随机化(Randomization)4.9.5+
音频(Audio)4.9.5+
带外资源(Out-of-band Assets)4.5.0+
文本(Text)4.1.3+
路径跟随(Follow Path)3.0.55+
状态插值(Interpolation on States)3.0.54+
摇杆(Joysticks)3.0.49+
独奏(Solos)3.0.42+
状态速度(Speed on States)3.0.38+
图形编辑器(Graph Editor)3.0.34+
监听器(Listeners)3.0.6+
网格形变(Mesh Deformation)3.0.1+
缓存 Rive 文件(Caching a Rive File)✅ Supported
光栅资源(Raster Assets)0.0.28+
事件(Events,已弃用)4.3.3+
嵌套文本(Nested Text,已弃用)4.14.0+
React - Canvas(React - Canvas)
特性支持状态 / 最低版本
脚本(Scripting)4.26.0+
数据绑定列表/图片/画板(Data Binding - Lists, Images, Artboards)4.22.0+
RTL 布局与文本(Right to Left Layouts & Text)4.18.6+
文本沿路径(Text Follow Path)4.18.6+
数据绑定(Data Binding)4.20.0+
矢量羽化(Vector Feathering)Not supported
N-Slicing(N-Slicing)4.16.7+
布局(Layouts)4.16.0+
后备字体(Fallback Fonts)Not yet supported
随机化(Randomization)4.9.5+
音频(Audio)4.9.5+
带外资源(Out-of-band Assets)4.5.0+
文本(Text)4.1.3+
路径跟随(Follow Path)3.0.55+
状态插值(Interpolation on States)3.0.54+
摇杆(Joysticks)3.0.49+
独奏(Solos)3.0.42+
状态速度(Speed on States)3.0.38+
图形编辑器(Graph Editor)3.0.34+
监听器(Listeners)3.0.6+
网格形变(Mesh Deformation)3.0.1+
缓存 Rive 文件(Caching a Rive File)✅ Supported
光栅资源(Raster Assets)0.0.28+
事件(Events,已弃用)4.3.3+
嵌套文本(Nested Text,已弃用)4.14.0+
React Native(Nitro)
特性支持状态 / 最低版本
脚本(Scripting)v0.1.5+
数据绑定列表/图片/画板(Data Binding - Lists, Images, Artboards)v0.1.4+
RTL 布局与文本(Right to Left Layouts & Text)v0.1.4+
文本沿路径(Text Follow Path)v0.1.4+
数据绑定(Data Binding)v0.1.4+
矢量羽化(Vector Feathering)v0.1.4+
N-Slicing(N-Slicing)v0.1.4+
布局(Layouts)v0.1.4+
后备字体(Fallback Fonts)Not yet supported
随机化(Randomization)v0.1.4+
音频(Audio)v0.1.4+
带外资源(Out-of-band Assets)v0.1.4+
文本(Text)v0.1.4+
路径跟随(Follow Path)v0.1.4+
状态插值(Interpolation on States)v0.1.4+
摇杆(Joysticks)v0.1.4+
独奏(Solos)v0.1.4+
状态速度(Speed on States)v0.1.4+
图形编辑器(Graph Editor)v0.1.4+
监听器(Listeners)v0.1.4+
网格形变(Mesh Deformation)v0.1.4+
缓存 Rive 文件(Caching a Rive File)v0.1.4+
光栅资源(Raster Assets)v0.1.4+
事件(Events,已弃用)v0.1.4+
嵌套文本(Nested Text,已弃用)v0.1.4+
Flutter(Flutter)
特性支持状态 / 最低版本
脚本(Scripting)0.14.1
数据绑定列表/图片/画板(Data Binding - Lists, Images, Artboards)0.14.0-dev.1
RTL 布局与文本(Right to Left Layouts & Text)0.14.0-dev.1
文本沿路径(Text Follow Path)0.14.0-dev.1
数据绑定(Data Binding)0.14.0-dev.1
矢量羽化(Vector Feathering)0.14.0-dev.1
N-Slicing(N-Slicing)0.14.0-dev.1
布局(Layouts)0.14.0-dev.1
后备字体(Fallback Fonts)Not yet supported
随机化(Randomization)0.13.4+
音频(Audio)0.13.4+
带外资源(Out-of-band Assets)0.12.0+
文本(Text)0.11.14+
路径跟随(Follow Path)0.11.6+
状态插值(Interpolation on States)0.11.4+
摇杆(Joysticks)0.11.1+
独奏(Solos)0.10.4+
状态速度(Speed on States)0.10.3+
图形编辑器(Graph Editor)0.10.0+
监听器(Listeners)0.9.0+
网格形变(Mesh Deformation)0.8.4+
缓存 Rive 文件(Caching a Rive File)✅ Supported
光栅资源(Raster Assets)0.8.1+
事件(Events,已弃用)0.11.17+
嵌套文本(Nested Text,已弃用)0.13.7+
Apple(Apple)
特性支持状态 / 最低版本
脚本(Scripting)v6.13.0+
数据绑定列表/图片/画板(Data Binding - Lists, Images, Artboards)v6.11.0+
RTL 布局与文本(Right to Left Layouts & Text)6.7.4+
文本沿路径(Text Follow Path)6.7.4+
数据绑定(Data Binding)6.8.0+
矢量羽化(Vector Feathering)6.6.0+
N-Slicing(N-Slicing)6.4.0+
布局(Layouts)6.3.0+
后备字体(Fallback Fonts)6.1.0+
随机化(Randomization)5.11.5+
音频(Audio)5.11.5+
带外资源(Out-of-band Assets)5.7.0+
文本(Text)5.1.5+
路径跟随(Follow Path)4.0.5+
状态插值(Interpolation on States)4.0.4+
摇杆(Joysticks)4.0.1+
独奏(Solos)3.1.9+
状态速度(Speed on States)3.1.7+
图形编辑器(Graph Editor)3.1.3+
监听器(Listeners)2.0.21+
网格形变(Mesh Deformation)1.0.18+
缓存 Rive 文件(Caching a Rive File)✅ Supported
光栅资源(Raster Assets)1.0.1+
事件(Events,已弃用)5.3.1+
嵌套文本(Nested Text,已弃用)6.1.0+
Android(Android)
特性支持状态 / 最低版本
脚本(Scripting)v11.1.0+
数据绑定列表/图片/画板(Data Binding - Lists, Images, Artboards)v10.4.0+
RTL 布局与文本(Right to Left Layouts & Text)10.0.4
文本沿路径(Text Follow Path)10.0.4
数据绑定(Data Binding)10.1.0+
矢量羽化(Vector Feathering)10.0.0+
N-Slicing(N-Slicing)9.12.0+
布局(Layouts)9.10.0+
后备字体(Fallback Fonts)9.7.0+
随机化(Randomization)9.3.5+
音频(Audio)9.3.5+
带外资源(Out-of-band Assets)8.6.1+
文本(Text)8.1.3+
路径跟随(Follow Path)6.0.1+
状态插值(Interpolation on States)5.1.5+
摇杆(Joysticks)5.0.0+
独奏(Solos)4.4.0+
状态速度(Speed on States)4.2.7+
图形编辑器(Graph Editor)4.2.2+
监听器(Listeners)3.0.8+
网格形变(Mesh Deformation)2.0.24+
缓存 Rive 文件(Caching a Rive File)✅ Supported
光栅资源(Raster Assets)2.0.5+
事件(Events,已弃用)Deprecated and will be removed in future versions
嵌套文本(Nested Text,已弃用)9.8.0+
C++(C++)
特性支持状态 / 最低版本
脚本(Scripting)✅ Supported
数据绑定列表/图片/画板(Data Binding - Lists, Images, Artboards)✅ Supported
RTL 布局与文本(Right to Left Layouts & Text)✅ Supported
文本沿路径(Text Follow Path)✅ Supported
数据绑定(Data Binding)✅ Supported
矢量羽化(Vector Feathering)✅ Supported
N-Slicing(N-Slicing)✅ Supported
布局(Layouts)✅ Supported
后备字体(Fallback Fonts)✅ Supported
随机化(Randomization)✅ Supported
音频(Audio)✅ Supported
带外资源(Out-of-band Assets)✅ Supported
文本(Text)✅ Supported
路径跟随(Follow Path)✅ Supported
状态插值(Interpolation on States)✅ Supported
摇杆(Joysticks)✅ Supported
独奏(Solos)✅ Supported
状态速度(Speed on States)✅ Supported
图形编辑器(Graph Editor)✅ Supported
监听器(Listeners)✅ Supported
网格形变(Mesh Deformation)✅ Supported
缓存 Rive 文件(Caching a Rive File)✅ Supported
光栅资源(Raster Assets)✅ Supported
事件(Events,已弃用)✅ Supported
嵌套文本(Nested Text,已弃用)✅ Supported
Unity(Unity)
特性支持状态 / 最低版本
脚本(Scripting)v0.4.1-canary.33+
数据绑定列表/图片/画板(Data Binding - Lists, Images, Artboards)v0.3.7-canary.142
RTL 布局与文本(Right to Left Layouts & Text)0.3.5+
文本沿路径(Text Follow Path)0.3.5+
数据绑定(Data Binding)0.3.6-canary.27
矢量羽化(Vector Feathering)0.3.3-canary.72+
N-Slicing(N-Slicing)0.2.2-canary.22+
布局(Layouts)0.2.1+
后备字体(Fallback Fonts)Not supported
随机化(Randomization)✅ Supported
音频(Audio)✅ Supported
带外资源(Out-of-band Assets)✅ Supported
文本(Text)✅ Supported
路径跟随(Follow Path)✅ Supported
状态插值(Interpolation on States)✅ Supported
摇杆(Joysticks)✅ Supported
独奏(Solos)✅ Supported
状态速度(Speed on States)✅ Supported
图形编辑器(Graph Editor)✅ Supported
监听器(Listeners)✅ Supported
网格形变(Mesh Deformation)✅ Supported
缓存 Rive 文件(Caching a Rive File)✅ Supported
光栅资源(Raster Assets)✅ Supported
事件(Events,已弃用)✅ Supported
嵌套文本(Nested Text,已弃用)✅ Supported
Unreal(Unreal)
特性支持状态 / 最低版本
脚本(Scripting)v0.4.20+
数据绑定列表/图片/画板(Data Binding - Lists, Images, Artboards)Not yet supported
RTL 布局与文本(Right to Left Layouts & Text)0.3.0a-gh
文本沿路径(Text Follow Path)0.3.0a-gh
数据绑定(Data Binding)0.3.0a-gh
矢量羽化(Vector Feathering)0.3.0a-gh
N-Slicing(N-Slicing)0.2.2+
布局(Layouts)0.2.1+
后备字体(Fallback Fonts)Not Supported
随机化(Randomization)✅ Supported
音频(Audio)✅ Supported
带外资源(Out-of-band Assets)Not yet supported
文本(Text)✅ Supported
路径跟随(Follow Path)✅ Supported
状态插值(Interpolation on States)✅ Supported
摇杆(Joysticks)✅ Supported
独奏(Solos)✅ Supported
状态速度(Speed on States)✅ Supported
图形编辑器(Graph Editor)✅ Supported
监听器(Listeners)✅ Supported
网格形变(Mesh Deformation)✅ Supported
缓存 Rive 文件(Caching a Rive File)Not yet supported
光栅资源(Raster Assets)✅ Supported
事件(Events,已弃用)✅ Supported
嵌套文本(Nested Text,已弃用)0.1.14+

Lite Runtime

Web - Canvas Lite(Web - Canvas Lite)
特性支持状态 / 最低版本
脚本(Scripting)2.34.0+
数据绑定列表/图片/画板(Data Binding - Lists, Images, Artboards)2.30.3+
RTL 布局与文本(Right to Left Layouts & Text)Not supported
文本沿路径(Text Follow Path)Not supported
数据绑定(Data Binding)2.26.6+
矢量羽化(Vector Feathering)Not supported
N-Slicing(N-Slicing)2.23.11+
布局(Layouts)2.23.3+
后备字体(Fallback Fonts)Not supported
随机化(Randomization)2.15.6+
音频(Audio)Not supported
带外资源(Out-of-band Assets)2.7.0+
文本(Text)Not supported
路径跟随(Follow Path)1.2.4+
状态插值(Interpolation on States)1.2.1+
摇杆(Joysticks)1.1.9+
独奏(Solos)1.1.2+
状态速度(Speed on States)1.0.102+
图形编辑器(Graph Editor)1.0.97+
监听器(Listeners)1.0.65+
网格形变(Mesh Deformation)1.0.47+
缓存 Rive 文件(Caching a Rive File)✅ Supported
光栅资源(Raster Assets)1.0.2+
事件(Events,已弃用)2.4.3+
嵌套文本(Nested Text,已弃用)Not supported
React - Canvas Lite(React - Canvas Lite)
特性支持状态 / 最低版本
脚本(Scripting)4.26.0+
数据绑定列表/图片/画板(Data Binding - Lists, Images, Artboards)4.22.0+
RTL 布局与文本(Right to Left Layouts & Text)Not supported
文本沿路径(Text Follow Path)Not supported
数据绑定(Data Binding)4.20.0+
矢量羽化(Vector Feathering)Not supported
N-Slicing(N-Slicing)4.16.7+
布局(Layouts)4.16.0+
后备字体(Fallback Fonts)Not supported
随机化(Randomization)4.9.5+
音频(Audio)Not supported
带外资源(Out-of-band Assets)4.5.0+
文本(Text)Not supported
路径跟随(Follow Path)3.0.55+
状态插值(Interpolation on States)3.0.54+
摇杆(Joysticks)3.0.49+
独奏(Solos)3.0.42+
状态速度(Speed on States)3.0.38+
图形编辑器(Graph Editor)3.0.34+
监听器(Listeners)3.0.6+
网格形变(Mesh Deformation)3.0.1+
缓存 Rive 文件(Caching a Rive File)✅ Supported
光栅资源(Raster Assets)0.0.28+
事件(Events,已弃用)4.3.3+
嵌套文本(Nested Text,已弃用)Not supported

Legacy Runtime(已弃用)

Web - WebGL(Legacy)
特性支持状态 / 最低版本
脚本(Scripting)2.34.0+
数据绑定列表/图片/画板(Data Binding - Lists, Images, Artboards)2.30.3+
RTL 布局与文本(Right to Left Layouts & Text)2.26.7+
文本沿路径(Text Follow Path)2.26.7+
数据绑定(Data Binding)2.26.6+
矢量羽化(Vector Feathering)Not supported
N-Slicing(N-Slicing)2.23.11+
布局(Layouts)2.23.3+
后备字体(Fallback Fonts)Not supported
随机化(Randomization)2.15.6+
音频(Audio)2.15.6+
带外资源(Out-of-band Assets)2.7.0+
文本(Text)2.1.3+
路径跟随(Follow Path)1.2.4+
状态插值(Interpolation on States)1.2.1+
摇杆(Joysticks)1.1.9+
独奏(Solos)1.1.2+
状态速度(Speed on States)1.0.98+
图形编辑器(Graph Editor)1.0.93+
监听器(Listeners)1.0.62+
网格形变(Mesh Deformation)1.0.44+
缓存 Rive 文件(Caching a Rive File)✅ Supported
光栅资源(Raster Assets)1.0.2+
事件(Events,已弃用)2.4.3+
嵌套文本(Nested Text,已弃用)2.21.0+
React - WebGL(Legacy)
特性支持状态 / 最低版本
脚本(Scripting)4.26.0+
数据绑定列表/图片/画板(Data Binding - Lists, Images, Artboards)4.22.0+
RTL 布局与文本(Right to Left Layouts & Text)4.18.6+
文本沿路径(Text Follow Path)4.18.6+
数据绑定(Data Binding)4.20.0+
矢量羽化(Vector Feathering)Not supported
N-Slicing(N-Slicing)4.16.7+
布局(Layouts)4.16.0+
后备字体(Fallback Fonts)Not supported
随机化(Randomization)4.9.5+
音频(Audio)4.9.5+
带外资源(Out-of-band Assets)4.5.0+
文本(Text)4.1.3+
路径跟随(Follow Path)3.0.55+
状态插值(Interpolation on States)3.0.54+
摇杆(Joysticks)3.0.49+
独奏(Solos)3.0.42+
状态速度(Speed on States)3.0.38+
图形编辑器(Graph Editor)3.0.34+
监听器(Listeners)3.0.6+
网格形变(Mesh Deformation)3.0.1+
缓存 Rive 文件(Caching a Rive File)✅ Supported
光栅资源(Raster Assets)0.0.28+
事件(Events,已弃用)4.3.3+
嵌套文本(Nested Text,已弃用)4.14.0+
React Native(Legacy)
特性支持状态 / 最低版本
脚本(Scripting)v9.8.0+
数据绑定列表/图片/画板(Data Binding - Lists, Images, Artboards)Not supported
RTL 布局与文本(Right to Left Layouts & Text)9.2.1+
文本沿路径(Text Follow Path)9.2.1+
数据绑定(Data Binding)9.3.0+
矢量羽化(Vector Feathering)9.0.0+
N-Slicing(N-Slicing)8.2.0+
布局(Layouts)8.1.0+
后备字体(Fallback Fonts)Not supported
随机化(Randomization)7.0.3+
音频(Audio)7.0.3+
带外资源(Out-of-band Assets)8.4.0+
文本(Text)6.0.3+
路径跟随(Follow Path)5.0.0+
状态插值(Interpolation on States)4.1.2+
摇杆(Joysticks)4.1.0+
独奏(Solos)4.0.4+
状态速度(Speed on States)4.0.1+
图形编辑器(Graph Editor)4.0.1+
监听器(Listeners)3.0.38+
网格形变(Mesh Deformation)2.1.37+
缓存 Rive 文件(Caching a Rive File)Not supported
光栅资源(Raster Assets)2.1.36+
事件(Events,已弃用)6.1.0+
嵌套文本(Nested Text,已弃用)5.8.2+